Copyright: Copyright ® 1988-1999 by TransEra Corp.
Citation: Copyright ® 1988-1999 by TransEra Corp.


Contents
What's New for TransEra HTBasic 7.0 for Windows

Chapter 1 	Installing HTBasic 7.0 for Windows

Chapter 2 	Getting Started

Chapter 3 	GUI Description

Chapter 4 	HTBasic 7.0 Enhancements

Other Manuals	Installing and Using Manual

Reference Manual

User's Guide

Copyright ® 1988-1999 by TransEra Corp.


Chapter 1 Installing HTBasic 7.0

HTBasic for Windows provides a Setup program on CD-ROM that makes it easy to install the application in Windows 95/98 or Windows NT 4.0. This section shows how to use the Setup program to install HTBasic for Windows, including:

•	Pre-Installation Checks

•	Installing on Windows 95/98/NT

•	Installing on Multiple Computers

•	Installing on a Network


Pre-Installation Checks

Before you install HTBasic for Windows, take a few minutes to do the following pre-installation checks.

Step 1: Check Your HTBasic for Windows Package

To make sure your package contents are complete, check them against the following list. If any of the items are missing or damaged, contact your reseller or your local distributor. In addition to this What’s new for TransEra’s HTBasic 7.0 for Windows manual (HEA-0065), the HTBasic for Windows package should include:

•	CD-ROM entitled “HTBasic for Windows"

•	CD-ROM entitled “ I/O Libraries”

•	Reference Manual (HEA-0043)

•	User’s Guide (HEA-0042)

•	Installing and Using Manual (HEA-0041)

Step 2: Learn About Technical Support

When you install HTBasic for Windows, be sure to complete the online Registration Card. A U.S. and an International mail in Registration Card with registration number labels and information on obtaining technical support are also included in the packaging.

When you complete the online registration, or return the registration card, we will be able to provide you with technical support, new product information, and HTBasic for Windows update information.

•	For North American technical support and product information, call 1-801-224-6550.

•	For international technical support please contact your local distributor.

Further information on HTBasic for Windows is available from the following sources:

The HTBasic for Windows Home Page on the World Wide Web. To open the HTBasic for Windows Home Page, use the URL http://www.htbasic.com once you are on the World Wide Web.

•	For a subscription to the TransEra HTBasic e-mail newsletter or to join a TransEra e-mail user’s group, please send your request via e-mail to “htb-support@transera.com”.

Step 3: Check System Requirements

The following table shows the recommended and minimum system requirements to install HTBasic for Windows. These requirements apply equally to Windows 95/98, and Windows NT 4.0.

Item	Minimum Requirements	Recommended Requirements
Processor	386/486/Pentium class processor.	Pentium class processor or better.
Memory	16 MB Ram.	32 MB Ram.
Drive Space	5 MB of free hard drive space .
Operating System	Windows 95/98 or Windows NT.
CD-ROM	CD-ROM drive or access to CD-ROM over a computer network.
Display Driver	HTBasic for Windows will run with a monochrome, 16-color, 256-color or 24-bit display driver.
Printers/ Plotters	HTBasic for Windows can send screen dumps to any graphics printer supported by Windows. Plotters must be HPGL or PostScript compatible.


Installing on Windows95/98/NT

To install HTBasic for Windows on Windows 95/98/NT, you will need to use the HTBasic for Windows CD.

NOTE

If you need to install the HP I/O Libraries or I/O cards, connect a printer or plotter, or connect an input device, see Chapter 6 - I/O Device Drivers in the Installing and Using Windows Version manual.

1  Insert the HTBasic for Windows CD. This CD has an autoplay feature which automatically launches the HTBasic Setup program. If it does not start automatically, click Start, Run, and type d:\cdsetup.exe (where “d” is your designated CD drive letter) in the text box and click OK.

2  Pay close attention to the License Agreement and the readme file as they appear during Setup. The readme file will give you the latest information on installation procedures and product developments. This file can also be referenced after Setup.

3  The initial Setup screen following the License Agreement file is the User Information screen. Please enter your name, company name (if applicable), and serial number in the corresponding lines. The eleven digit serial number can be found on the back of the CD jewel case. Correct input of the number is required to complete the installation. Please save the original CD and serial number for future reference.

4  Please follow the instructions in the Setup program until installation is complete.


Installing on Multiple Computers

Since HTBasic for Windows is not copy protected,  you may install HTBasic for Windows on more than one computer. However, HTBasic for Windows is copyrighted, protected by international treaty and provided to you only under license.

You have license to run HTBasic for Windows on only one computer at a time. To install HTBasic for Windows on more than one computer, repeat the installation instructions in “Installing on Windows 95/98/NT”.


Installing on a Network

HTBasic for Windows can also be installed on a network, but a license must be purchased for each user who will concurrently use it.

Before you can install HTBasic for Windows from or on a network, the system administrator must place the files on the network and configure them. Contact your system administrator for the network path name for your computer. To install HTBasic for Windows on the network, follow the installation instructions in “Installing on Windows 95/98/ NT”.


Starting HTBasic for Windows

This section gives guidelines to start HTBasic for Windows, including:

•	Creating a Shortcut Icon

•	Setting Automatic Startup

•	Starting the Application

•	Using Online Help

•	Exiting HTBasic for Windows

NOTE

Creating a shortcut icon and/or setting automatic startup for HTBasic for Windows are optional steps. If you do not want to create either item, skip to “Starting the Application”.


Creating a Shortcut Icon

The standard installation creates a shortcut icon on the desktop. You may create additional shortcuts to open HTBasic for Windows. Figure 1-2 shows a typical shortcut icon for HTBasic for Windows (identified as a shortcut by a jump arrow in the lower left-hand corner). Double-click the icon to open HTBasic for Windows from the shortcut.  To create a HTBasic for Windows shortcut icon:

1  Right-click an empty area on the desktop to display a menu.

2  Point to New and click Shortcut to display the Create Shortcut dialog box.

3  Use Browse... to find and enter the path name on the Command line. By default HTBasic is installed at c:\program files\htbwin.

4  Click Next and then type a desired name for the shortcut icon.
Then, click Finish to display the icon on the desktop.

5  Drag the icon to a desired location on the desktop or right-click
the mouse in the desktop and click Arrange Icons or Line up Icons.


Setting Automatic Startup

You can set up HTBasic for Windows to start automatically when
Windows is started. After the startup information is created, the next
time Windows is started HTBasic for Windows is automatically started. HTBasic for Windows then executes an autostart (AUTOST) program.

To set HTBasic for Windows for automatic startup:

1  Click Start and point to Settings and then click Taskbar... to
display the Taskbar Properties dialog box.

2  Select Start Menu Programs, Start Menu Program Tab and click Advanced... to display the Exploring - Startup dialog box.

3  Open the Start Menu Programs folder by double clicking on the Programs folder and then double-click the StartUp folder. If you have not created a HTBasic for Windows shortcut icon, see “Creating a Shortcut” to create the icon.

4  Copy the shortcut icon to the StartUp folder by holding the
Ctrl key down and dragging the icon to the right side of the
dialog box. Then, release the mouse button to copy the icon.

5  Close the StartUp dialog box and restart Windows. After Windows has opened, HTBasic for Windows is automatically started.


Starting the Application

You can start HTBasic for Windows from the program group created by the Setup program or from the shortcut you created. To start HTBasic for Windows, click Start | Programs | TransEra HTBasic | HTBasic or double-click the shortcut icon. The initial display should be similar to that shown in Figure 1-3.


Using Online Help

HTBasic for Windows includes a Help menu. To access the Help menu, click the left mouse button on the Help menu to display the pulldown menu.


Using Windows Help System

Clicking the Using Help menu item displays the Windows Help dialog box (see Figure 1-4) that you can use to learn about the Windows help system. This dialog box consists of four books and each book consists of a number of topics. For example, in Figure 1-4 Installing and Using Manual is an open book with one topic and ten closed sub-books. Note that a book can include other books as well as topics.

To open a closed book, double-click the book title or use the “Open” box. To close an open book, double-click the book title or use the “Close” box. To display a specific help topic, click the topic name and then click “Display” or double-click the topic name.

Highlighting a topic name and clicking “Print...” allows you to print the topic. Highlighting a book name and then clicking “Print...” allows you to print all the topics in the book (whether the book is open or closed). For example,  in Figure 1-4 since Chapter 5 Graphic Input Drivers book is highlighted, clicking “Print...” allows you to print the entire book.


Using the Help Dialog Box

The Help Topics dialog box is the primary way to access online help topics. To display the Help dialog box, select the Help menu from the application window or the output window. Then:

•	Click Help|Topics to display the What’s New online manual.

•	Click Help|Index to display the Help Dialog Box.

•	Click Help|About... for information about HTBasic for Windows

•	Click Help|Using Help for Windows Help

Figure 1-4 shows a typical Help dialog box. In HTBasic for Windows, the Contents Tab, Index Tab, and Find Tab can be used from the Help dialog box.


Exiting HTBasic for Windows

You can use any of the four methods in Figure 1-5 to close the application window,  close all open files, shut down HTBasic for Windows, and return to Windows.


Chapter 2 Getting Started

Using This Chapter

This chapter provides guidelines to get started using the Graphical User Interface (GUI) to create, run, and edit HTBasic for Windows programs, including:

Getting Started
Introducing the GUI
Creating Programs
Running Programs
Search and Replace Operations
Setting the Environment

Getting Started

Figure 2-1 shows a typical sequence to get started developing, and editing HTBasic for Windows programs and to set the GUI environment.

NOTE

You can set the environment before you create or run programs or you can set or change the environment at nearly any time during program development. However, to help you quickly get started programming, we will discuss setting the environment at the end of this chapter.


Introducing the GUI

This section introduces the GUI, including the following topics. See Chapter 3 - GUI Description for additional information.

•	What is the GUI?

•	GUI Windows


What is the GUI?

All program development, editing, and debugging in HTBasic for Windows is done via the Graphical User Interface (GUI). The GUI provides an easy, flexible way to develop and edit HTBasic for Windows programs using standard Windows techniques. The GUI is fully compatible with previous versions of HTBasic for Windows and with programs developed in earlier versions of the HP BASIC language.


GUI Windows

There are two windows for HTBasic for Windows: application window and program window (see Figure 2-2). Depending on the operating mode of the program, some window elements change.


Creating Programs

This section gives guidelines to create HTBasic for Windows programs, including the following topics.

•	Using the Application Window

•	Creating a Program

•	Saving a Program

•	Opening a Program

•	Printing a Program

•	Closing a Program


Using the Application Window

The application window (see Figure 2-3) provides a framework window from which you can develop HTBasic for Windows programs. See Chapter 3 - GUI Description for more information on
the application window.


Example: Adding the Control Toolbar

To open an application window (with an enclosed program window) and to display the control toolbar:

1  Exit and restart HTBasic for Windows.

2  Display the control toolbar by clicking the mouse button on
the View menu and then on the Control Toolbar menu item.

3  The application window display should look like Figure 2-3.


Positioning the Window

When HTBasic for Windows is saved or closed and then restarted, the application window is returned in the size and position it had when the application closed. As desired, you can reposition and/or resize the window using standard Windows mouse techniques.


Using the Menus

There are ten (10) pulldown menus for the GUI. Each application window pulldown menu uses standard Windows features, including shortcut keys (Alt+O for Open..., etc.). All menu items are displayed for each pulldown menu, but inactive items for a specific mode of operation are greyed out. Each pulldown menu can be accessed using the mouse cursor or Alt keys.


Example: Using File|Open Menu

This example shows two ways to access the File|Open menu item.

1  Use the mouse cursor to open the File menu and then highlight File|Open.... Click the mouse button or press Enter to display
an Open dialog box or:

2  Use Alt+F to open the File menu - do not release the Alt key.
Then, press O (or o) to display the Open dialog box.


Using the Status Bar

The status bar is located at the bottom of the application window and includes the message area and status indicators. The message area at the left side of the status bar displays icon tooltip information. The status indicators display the states of various keyboard keys.


Using the Control Toolbar

The control toolbar contains icons that represent shortcuts for certain menu items. When you pause your cursor over a control toolbar icon, the icon title (such as New, Open, Find, etc.) appears and the icon description is displayed in the status bar message area.


Example: Using the Control Toolbar

Placing the arrow cursor over the Run icon as shown in Figure 2-4 causes the icon title (Run) to appear beneath the icon and the icon action (Run Program) to appear at the left-hand side of the status bar. Clicking the Run icon executes the icon action (Run the Program).


Creating a Program

To create a new program you can enter text directly onto the program window from the keyboard. To create a new program:

1  If a program window (one with no text) is not displayed, click File|New to create a new untitled program.

2  Type the program lines from the keyboard to create a Source program. Begin typing at the caret (blinking _ icon). Backspace
and retype to correct errors.

3  Press the Enter key after each line to parse the line and move the cursor to the next line.


Example: Creating a  Program

1  Exit and restart HTBasic for Windows to display an application window with an untitled program window.

2  Type EDIT, and the program lines shown in Figure 2-5 from the keyboard. Begin typing at the caret (the blinking _ icon) on the program window. Press the Enter key after entering each line of code. If you make a typing mistake, backspace and retype.


Saving/Storing Programs

Clicking File|Save As/Store As from the application window menu saves or stores the program under the currently specified file name with one of the following five extensions, the file type depends upon the menu choice (Save or Store):

•	PROG (*.prg)[stored]

•	BASIC Program (*.bas) [stored]

•	Text (*.txt) [saved]

•	LIF ASCII (*.lif) [saved]

•	HP LIF ASCII (*.lhp) [saved]

To save or store a program:

1  Click File|Save/Store or File|Save As/Store As... to display the Save/Store As dialog box. If the file already exists, the file will be saved or stored to the same name and type as already exists without bringing up the Save/Store dialog box.

2  Type the file name in the “File name:” box. Select the file type from the “Save as type:” pulldown box. Select the directory to save/store the file from the “Save in:” box.

3  Click the “Save” or “Store” button to save/store the file.

Once saved and modified, an asterisk “*”after the title in the program window title bar shows that the program has been modified from the original source.


Example: Storing a Program

This example shows one way to store the program created in the previous example. See Figure 2-6 for a typical Save As dialog box.

1  Click File|Store or File|Store As... to display the Store/Store As dialog box.

2  Type example in the “File name:” box and select PROG (*.prg) as the file type. Select a directory in which to store the program.

3  Click “Store” to store the program as a PROG file.


Reverting to Last Saved/Stored Version

Clicking File|Revert to Last... from the application window menu opens the last saved/stored version of the file and cancels all changes that occurred since the file was last saved/stored.


Saving/Storing Programs As

If you want to save or store the program under the same or a different file name or file type, clicking File|Save As / Store As... displays a standard Save / Store As dialog box from which you can rename and/or retype the file to be saved/stored.


Opening a Program

You can use the File menu from the application window to open an existing program by using File|Open... or File|Recent File 1-16... menu items. Clicking File|Open... displays a standard Open dialog box (see Figure 2-7) from which you can select the file to open. You can display the files for any of the file types shown in the dropdown box.


Opening Existing Programs

After a program has been created and saved, you can open the program.   To open a program:

1  In the HTBasic application window, click File|Open... or click the control toolbar Open icon to display the Open dialog box.

or..

2  If the file to be opened has been recently saved/stored, click File|Recent File1...16 (and click on the appropriate file from the recent file list) to open the desired program.


Example: Opening a Program

For this example, we will use File|Recent File1...16 to open the example.prg program we stored in the previous example. To do this:

1  Exit and restart HTBasic for Windows to display an application window and a new program window.

2  Click the x icon in the program window to close the window.

3  Click File|1 example.prg to open the program.


Printing a Program

For both new and existing programs, you can use File|Print program to print the program to a file or to a selected printer.  To print a program to a printer:

1  Click File|Print Program to display the Print Program dialog box.

2  Select the Output device, and the print range desired.

3  Click OK to print the program.


Example: Printing a Program

This example shows one way to print the example.prg program
to a selected printer.

1  Open the example.prg program.

2  Click File|Print Program to display the Print Program dialog box.

3  Un-check “Use PRINTER IS device” and input your desired Output Device, for this example use “26”. ISC 26 is a direct pipe to your lpt1 port.

4 Deselect Print Whole Program, enter From line 10 To line 30, and click OK. (see Figure 2-8)


Print Setup

You can use the Print Setup dialog box (see Figure 2-9) to set the printer properties. To access the Print Setup dialog box from the application window or program window menu choose File | Print Setup.


Closing a Program

Once a program has been saved/stored, you can close the program.

If you have not made any changes to the program to be saved, the file is saved in the same format and with the same file name. If you attempt to close the program or exit the application without first saving, a File Changed dialog box (see Figure 2-10) is displayed.

When the program has been closed, the application window reverts to the inactive mode (no program window is displayed). To close a program:

1  Click File|Close to display a File Changed dialog box (does not appear if no changes have been made to the program).

2  Click “OK” to discard the changes in the program and to delete the program window or click “Cancel” to return to the program window.


Running Programs

Once a program has been created, you can run the program to produce the program output.  This section gives guidelines to get started running programs,  including these topics.

•	Running a Program

•	Pausing a Program

•	Stopping a Program


Running a Program

When a new program has been created or an existing program has been opened,  you can use Run|Run from the application window menu or use the Run (right-facing green arrow) icon on the control toolbar to run the program. To run a program:

1  Open a program.

2  Click Run|Run or the Run icon to run the program.


Example: Running/Pausing a Program

This example shows a way to run and pause the example.prg program.

1  Open the example.prg program.

2  Click Run|Run or the Run icon to run the program.

3 Click Run|Pause or the pause icon (yellow double bar) to pause the program.

4  The display should be similar to Figure 2-11.


Running a Program From a File

You can use File|Run Program... to run a program directly from a file without opening the file. You can run the program before you open any other files, or you run the program when the application is in edit mode. When File|Run Program... is executed, a standard Open File dialog box appears from which you can select a program to be run directly from the file, without having to first open the file.


Pausing Programs

You can pause a running program by using the Run|Pause menu, pushing the pause (yellow double bar) icon, or using the System F4 menu key.


Stopping Programs

You can stop a running program by using the Run|Stop menu or pushing the stop (red square) icon.

When the program stops (or is paused), you can rerun the program by using the Run|Run menu, or clicking the Start (right-facing green arrow) icon in the control toolbar or by clicking the Run (F3) softkey from the System Menu softkeys.


Search and Replace Operations

This section  gives guidelines to edit HTBasic for Windows programs, including these topics.

•	Moving in the Program Window

•	Finding Items

•	Replacing Items

•	Going to Items


Moving in the Program Window

In the previous section we used the program window primarily to display the program code, but did not make any edit changes to the program.

The GUI uses Windows actions for using the mouse. Clicking the mouse on text that you wish to edit causes the _ to appear under the letter you selected. The mouse can also be used to move the cursor in the program by dragging the vertical scroll bar on the right side of the program window. If your mouse has a wheel, the wheel can be used to move the cursor as well.


Finding Items

When the application is in the program window, you can use Search|Find... to find a specified item in the open program. Clicking this menu item displays a standard Find dialog box (see Figure 2-12). When a string is typed into the “Find String” box, the search will look for the next use of the string, all uses of the specified string, or any use of the string within a defined range.


Finding First Occurrence of an Item

From the Find dialog box, type in the string to be found. Clicking the “OK” box finds the next occurrence of the specified item. To find the first occurrence of an item the search must; (1) start at the beginning of the program, or (2) the search must define the program start as the beginning range of the search.

All searches are case sensitive. Care must be exercised to provide the correct spelling and case for accurate results.


Finding Next Occurrence of Items

Unless a range is specified, all searches begin at the point where the search is initiated and search forward through the code. To find multiple instances of a specified item simply push the “Enter” key after finding the first occurrence of the search. The search function automatically takes the cursor to the next occurrence of the string. Using any other key exits the search and returns to the program window.


Menu Procedures

The following table provides an outline of the procedures required to initiate and complete a search or find operation.

Search and Replace Operations

Finding Items	Find first occurrence  of item	1 Place the cursor at the beginning of the program 2 Click Search|Find... or the Find icon 3 In the Find dialog box, type the string to be found in  the “Find String:” box and click “OK”                                or 1 Click Search|Find... or the Find icon  2 In the Find dialog box, type the string to be found in  the “Find String:” box  3 If the cursor is not at the program start, define the range of the search with the program’s start as the beginning of the search range  4 Click the “OK” button to start the search
	Find the next occurrence of an item	1 Find the first occurrence of an item as described above  2 Push the “Enter” key to move the cursor to the next instance of the search


Replacing Items

Use Search|Replace... to replace one or more occurrences of an item. Selecting Search|Replace... displays the Change dialog box, similar to that shown in Figure 2-13. To replace a selected item in the program using the Change dialog box:

1  Type in the text to be changed in the “Old String:” box and type in the desired changed text in the “New String”: box.

2  Choose to “Change All”, “Change all in a range”, or leave both blank to have each change confirmed.

3  Click “OK” to proceed with the Search|Replace.. or “Cancel” to quit.


Example: Replacing an Item

For the Change dialog box in Figure 2-13, clicking “OK” or pressing the “Enter” key makes the replacement and moves the cursor to the next instance of the old string and queries the user before each replacement.

Selecting the “Change All” option will change every use of the old string to the new string without querying the user.

If a range is specified, the search will find the first use of the old string in the range and query the user if the change is wanted. Pressing the “Enter” key makes the replacement and moves the cursor to the next instance in the selected range and queries the user again.

Editing the line found by the search and replace operation is allowed, but moving off of the line using any method other than pressing the “ENTER” key exits the search/replace menu and returns to the program window.


Going to Items

In the edit mode, clicking Search|Goto... displays the Goto dialog box (see Figure 2-14). From the Goto dialog box, you can select a line number (check Line), a line label (check Label), a function (check FN) or a Subprogram (MAIN is considered to be a subprogram) (check Sub) as the Goto Item.


Example: Going to a Subprogram

For the example program illustrated in Figure 2-5, clicking Search|Goto..., selecting “Sub” in the Goto Item box (see Figure 2-14), entering SUB Readme as the Sub request, and clicking OK moves the cursor to the Readme Sub (line 80).


Menu Procedures

The following table provides an outline of the menu procedures required to initiate and complete a Goto operation.

Search and Replace Operations

Going to Items	Go to Line/Label/ Subprogram/Function	1 Place the cursor anywhere within the program 2 Click Search|Goto... 3 Use the Goto dialog item box to select a line, a label, a subprogram, or a function as the Goto item 4 Enter line number, line label, SUB or FN Name 5 Click “OK”


Setting the Environment

This section gives guidelines to get started setting the environment for HTBasic for Windows, including the following topics:

•	Configuring the Edit Environment

•	Changing MSI

•	Alt key behavior

•	Defining Cross-Reference lists (XREF)

•	Aborting I/O Operation

•	Resetting the Interface


Configuring the Edit Environment

You can use the Options|Edit Environment... menu from the program window to change the edit environment. Any changes made to the Edit Environment dialog box will appear in all programs when they are opened.

To set the Edit Environment, select the Options|Edit Environment... menu to display an Edit Environment dialog box similar to that shown in Figure 2-15. To change an item, click the desired item on the configuration tab.

To return all settings to the default state, click the “Default” button at the bottom of the dialog box.

The following table shows the results of the settings for each of the six options in the CONFIGURE tab. In the table, the default setting is shown in bold italics.

CONFIGURE Tab Settings

Box	Item	Result
CONFIGURE BDAT	MSB FIRST	CONFIGURE BDAT specifies the byte ordering to use with each BDAT file created after this statement is executed. Since HP BASIC/9000 can only use MSB FIRST files, to create BDAT files that can be used on an HP BASIC workstation, use CONFIGURE BDAT MSB FIRST before creating the files.
	LSB FIRST	By default, BDAT files are created with the same byte order as the computer. HTBasic for Windows uses LSB FIRST.
CONFIGURE CREATE	HP	CONFIGURE CREATE specifies the kind of file header (“HP” or “HTB”) to use when creating an untyped or BDAT file. HP file headers are compatible with files created on BASIC/9000 workstations. Use CONFIGURE CREATE HP to import these files.
	HTB	HTBasic for Windows creates “HTB” file headers. BDAT files with “HTB” file headers can be created with data in either LSB or MSB byte ordering (see CONFIGURE BDAT).
CONFIGURE DIM	ON	CONFIGURE DIM turns implicit variable and string dimensioning ON or OFF. The default is CONFIGURE DIM ON.
	OFF	With CONFIGURE DIM OFF, each variable, string and array must be explicitly declared using REAL, INTEGER, COMPLEX or DIM statements.
CONFIGURE LONGFILE- NAMES	ON	HTBasic for Windows allows long filenames (up to about 256 characters), and filenames can have embedded spaces. To enable display and use of long filenames, use CONFIGURE LONGFILENAMES ON (default).  With LONGFILENAMES ON, spaces are not deleted from directory and file specifiers. Also, the listing format for CAT  is changed to accommodate varying length filenames.
	OFF	With LONGFILENAMES OFF, HTBasic for Windows removes embedded spaces from file specifiers and CAT listings do not have enough room for long filenames, so long filenames cannot be used with this setting.
CONFIGURE MSI	ON/OFF	CONFIGURE MSI specifies a file path specifier to be substituted for an HP BASIC/9000 msvs (mass storage unit volume specifier). Directory names must end with a directory separator character. Specifying a new path specifier for a defined msvs replaces the previous definition. Specifying a zero length path specifier removes the previous definition.  File names of one letter followed by an msvs (e.g., C:,702,1) and file names with an embedded colon (e.g., xnews.sun:0)  will be misinterpreted. MASS STORAGE IS translation can be turned off with CONFIGURE MSI OFF when such conflicts arise. To turn translation back on, use CONFIGURE MSI ON.
CONFIGURE SAVE ASCII	ON	CONFIGURE SAVE ASCII sets the file type SAVE or RE-SAVE uses when saving a file to a disk. CONFIGURE SAVE ASCII ON (the default), produces a LIF ASCII file. This type of file is useful for exchanging programs with BASIC/9000 workstations that cannot GET DOS ASCII or UNIX ASCII program files.
	OFF	CONFIGURE SAVE ASCII OFF produces an untyped file. RE-SAVE produces the same file type as an existing file or the file type specified by CONFIGURE SAVE ASCII if no file exists. GET can read either file type.


Changing the MSI

You can use the Options|Change MSI... menu from the program window to change the MASS STORAGE IS (MSI) path and device specifier . The current MSI includes both the device and the current directory. This current directory is searched first to find any specified files.

To change the MSI, select the Options|Change MSI... menu to display a Change MSI dialog box similar to that shown in Figure 2-16.


Setting Alt Key Behavior

You can use the Options|Alt Key Behavior... menu from the program window to assign the behavior of the Alt key to either HTBasic for Windows or the Windows OS.

To assign the Alt key behavior, use the Options|Alt Key Behavior menu. A check will appear by either the HTBasic Settings menu option or by the Windows Default menu option designating which option has been assigned control.

To assign the Alt key behavior to Windows, highlight the Windows Default menu option and click with the mouse or push the “Enter” key. These settings include functions like accessing pull down menus (please see your Windows documentation for a complete description of Alt key assignments).

To assign the Alt key behavior to HTBasic for Windows, highlight the HTBasic Settings menu option and click with the mouse or push the “Enter” key. In addition to System Softkeys which can be invoked with the Alt key, several other functions are invoked by holding down the Alt key while pressing one of the regular alphabetic keys. Please consult Chapter 2 of your Installing and Using HTBasic for Windows manual for a complete list of HTBasic functions assigned to the Alt Key.


Defining Cross- Reference Lists

In addition to setting the program window environment, you can also use the View menu to define Cross-Reference lists.

The XREF (Cross-Reference) statement generates a cross reference list of line labels, I/O path names, numeric and string variables, subprograms, functions and COM block names. It also lists the number of unused symbol table entries. You can select the cross-reference entries for your application. To define (X-REF) Cross-reference statement:

1 From the program window Click View | XREF to open the
XREF dialog box
2 Choose a subprogram to define XREF in
3 Choose an output device or check “Use Default Output” box
4 Select one of the options pictured in figure 2-17
5 Select “OK” to define the XREF list, “Cancel” to return to
HTBasic, or choose “Default” to reselect XREF options


Resetting the Interface

Run|BASIC Reset directed to an interface performs an interface reset. Run|BASIC Reset directed to a file sets the file position pointer to the beginning of the file. Run|BASIC Reset directed to a buffer sets all buffer control entries to their initial values with the empty and fill pointers set to one and all other entries set to zero. Run|BASIC Reset asserts the IFC line for more than 100 μsec, clears interrupts and, if the interface is the system controller, sets it to be the active controller.


Aborting an I/O Operation

Run|Clear I/O aborts an I/O operation that is in progress. Unless
timeouts have been enabled, the system will wait indefinitely for an I/O operation to complete. Executing Run|Clear I/O (or using Alt + F5) forces the program to return to a paused condition. Executing a CONTINUE function (use Alt + F2) causes the I/O statement to be re-executed.


Chapter 3 GUI Description

Using This Chapter

This chapter describes the HTBasic for Windows Graphical User Interface (GUI), including:

Application Window Description
Program Window Description
GUI Menus


Application Window Description

When HTBasic for Windows first starts, the application window
(and an enclosed Program Window) appears. The application window provides a framework window from which you can develop HTBasic for Windows programs. This section give guidelines to use the GUI application window, including:

•	Application Window Displays

•	Application Window Elements

•	Positioning the Window

•	Using the Status Bar

•	Using the Control Toolbar

•	Moving the Control Toolbar


Application Window Displays

Figure 3-1 shows a typical application window display when no programs are open (inactive state). Figure 3-2 shows a typical application window display when a program is open (active state).

There are two main differences in application window displays for active state and inactive state. In the inactive state, the menu bar has only four menus and no Program Window is displayed. The inactive state occurs when no program is open. In the active state, the full menu bar of seven menus is displayed and the Program Window is displayed.


Application Window Elements

Figure 3-3 shows the elements of a typical application window (with enclosed Program Window). The table following Figure 3-3 summarizes the application window elements.

Application Window Elements

Title Bar	The title bar consists of the name of the application, the application icon, the program name, and the minimize, maximize, and the close buttons.
Menu Bar	The menu bar contains the pulldown menus you can use for program development. See “GUI Menus,” page 3-11, for details on the menus.
Control Toolbar	The control toolbar is shown when theView|Control Toolbar menu item is checked or is hidden when View|Control Toolbar is unchecked. The toolbar contains images that represent shortcuts for certain menu items. By clicking a control toolbar button, the action performed is the same action as selected from the menu. See “Using the Control Toolbar” for details on using the control toolbar.
Display Area	The display area is always present during the entire operation of the application. The Program Window created by the application remains within the display area.
Status Bar	The status bar is displayed when the View|Status Bar menu item is checked or is hidden when this menu item is unchecked. See “Using the Status Bar” for details on using the status bar.


Positioning the Window

When HTBasic for Windows is saved or closed and then restarted, the application window is returned in the size and position it had when the application closed. See Figure 3-4 for procedures to set the application window position and to resize the application window.


Using the Status Bar

The status bar (see Figure 3-5) is located at the bottom of the application window and provides information about the keyboard status of HTBasic for Windows. You can show the status bar by checking the View|Status Bar menu item in the application window. You can hide the status bar by unchecking View|Status Bar.

The status bar includes two areas: message area and status indicators.

The message area at the left side of the status bar displays the name of the control toolbar icon when it is highlighted by the mouse (Run Program icon in Figure 3-5). Menu information also appears in the message area when the user selects a menu.

The status indicators display the current operating state of several keyboard keys. The current state indicates whether the keyboard has capslock, num lock, or scroll lock keys on.


Using the Control Toolbar

The control toolbar can be displayed on the application window. The control toolbar is shown when the View|Control Toolbar menu item is checked or is hidden when View|Control Toolbar is unchecked.

The toolbar contains images that represent shortcuts for certain menu items. By clicking a toolbar button, the action performed is the same action as selected from the menu. When the application window is in an inactive state, all toolbar buttons except “New” and “Open” are greyed out. Figure 3-6 shows a typical control toolbar display.

The title bar for the control toolbar is present when the toolbar is in a floating state. When you click a control toolbar icon, the icon title (such as New, Cut, Find, etc.) appears and the icon description is displayed in the status bar message area.

The control toolbar can be docked to any of the four sides in the display area or can be floating anywhere in the window, including outside the main application window (see “Moving the Control Toolbar”).


Example: Using the Control Toolbar

Placing the arrow cursor over the Run icon (icon #8) as shown in Figure 3-6 causes the icon title (Run) to appear beneath the icon and the icon action (Run program) to appear at the left-hand side of the status bar(see Figure 2-4). Clicking the Run icon executes the icon action (Runs the program).


Moving the Control Toolbar

When the Control Toolbar is displayed, it can be displayed below the application window menu bar (default), it can be docked to any side of the application window borders or it can be floating anywhere on the screen.

To move a toolbar, click anywhere inside the toolbar outline (except on an icon), hold the mouse button down, drag the outline to the desired location and then release the mouse button.

To dock a toolbar to the left or right side of the application window,
hold the mouse button down and drag the outline left or right until the outline changes to a vertical rectangle. Release the mouse button and the toolbar is docked to the side of the window. When the application is exited and then restarted, the toolbars are displayed in their exit state locations.


Example: Moving the Control Toolbar

Figure 3-7 shows a floating Control Toolbar in the right margin of the application window when the application is in the active state. Since the Control Toolbar is floating, the title bar for the Control Toolbar is displayed.


Program Window Description

The Program Window provides the area you can use to develop and edit programs. The Program Window has no associated menus other than a context menu for the title bar. This section describes the program window, including:

•	Program Window Elements

•	Setting Alpha/Graphics display


Program Window Elements

Figure 3-8 shows the elements of a typical Program Window (maximized) enclosed in an application window. The table following Figure 3-8 describes the Program Window elements.

Program Window Elements
Title Bar	Includes program name and location. An * is appended to the program title if the source or program has been modified since the last save. The title bar is hidden when the program window is maximized (default), but the program name and location is shown in the application window’s title bar.
Display Area	Where program is displayed. This area starts at the top line of the screen below the title bar (minimized) or at the top line of the screen below the control toolbar when maximized, and extends down to one line above the message line.
Message Line	Displays error messages, live keyboard calculator results, and status indicators. Messages are limited to 63 characters in length.
Softkey Menu	A softkey is a function key (F1 — F 10) with programmable output. Displays labels corresponding to each softkey. The label indicates the action that is performed when the corresponding function key is pressed. Softkeys can be hidden or displayed.
Vertical Scrollbar	Allows scrolling up or down in a program using standard Windows operation. Scrolling can also be done automatically when moving through text. When the caret moves beyond the window boundaries, the window scrolls accordingly.
Figure 3-9 shows a typical Program Window (not maximized) with a file name, an error in the message line, softkeys and titlebar.


Setting Alpha/Graphics Mode

This section gives guidelines to set alpha/graphics mode.

•	Program Window Graphics Description

•	Separate Alpha/Graphics Mode

•	Merged Alpha/Graphics Mode


Graphics Description

HTBasic for Windows has two modes of operation for output alpha (text) and graphics: separate alpha and graphics and merged alpha/graphics.

The (0,0) position for HTBasic for Windows graphics is the lower left corner of the display. Pasting graphics to the clipboard is not supported in HTBasic for Windows. The graphics mode is set as MERGE ALPHA WITH GRAPHICS or SEPARATE ALPHA FROM GRAPHICS programmatically.


SEPARATE ALPHA FROM GRAPHICS mode

With SEPARATE ALPHA FROM GRAPHICS mode, two separate bitmaps are created, one for alpha and one for graphics. The alpha and graphic planes can then be turned on or off independently. The two bitmaps are then merged to form a single display on the program window. In this mode, you can display, save, and print separate alpha and graphics. DUMP ALPHA only dumps the alpha and DUMP GRAPHICS only dumps the graphics.


Merged Alpha/Graphics Mode

In MERGE ALPHA WITH GRAPHICS mode, a single bitmap file is created that includes both alpha and graphics planes. For this mode, alpha text is converted to graphic pixels and written into the graphics planes, overwriting any graphics data that might be present.

In this mode, you can display, save, and print only merged alpha and graphics.  When scrolling the program window in this mode, the text and graphics are both scrolled. Dumping either alpha or graphics dumps both, and the full range of colors is available to both alpha and graphics output.


GUI Menus

This section describes the menus for HTBasic for Windows, including:

•	Menus Overview

•	File Menu

•	Help Menu

•	Options Menu

•	View Menu

•	Run Menu

•	Search Menu

•	Edit Menu


Menus Overview

HTBasic for Windows includes ten types of pulldown menus you
can use to develop HTBasic for Windows programs. Figure 3-10 shows a typical menu display and an expanded view of the Run menu. The actual display for all the pulldown menus depends on the type of window displayed. Each pulldown menu uses standard Windows displays, including shortcut keys (Atl+F+O for Open..., etc.).

All menu items are displayed for each pulldown menu, but the inactive items for a specific mode of operation are greyed out. For example, in Figure 3-10 the menu items Pause, Stop, and Continue are shown as inactive.

For each menu or menu item, the convention used is Menu|Menu Item. For example, File|Open... refers to the Open menu item in the File menu. A menu item followed by three dots (such as File|Open...) means that a dialog box is opened when the menu item is selected. The underlined letter is the menu accelerator key (such as F) or menu item accelerator key (such as O). There are two main ways to access a menu item - mouse cursor or Alt key - as described in the following table.

Method	Description
Use the Mouse Cursor	You can use the mouse cursor to open the menu and then highlight the menu item. Click the mouse button or press Enter to perform the menu item action.
Use the Alt Key	For some menu items, you can use Alt+menu item accelerator key to perform a menu item action. To do this, first open the menu with Alt+menu accelerator key but do not release the Alt key. Continue to hold down the Alt key and press the menu item accelerator key. The key sequence shown in the menu tables is Alt+menu accelerator key+menu item accelerator key.


Example: Using File|Open Menu

For example, suppose you want to open a file using the File|Open menu item. You can use any of the previous two methods, each of which results in the Open dialog box being displayed.

•	Use the mouse cursor to open the File menu and to highlight File|Open.... Click the mouse button or press Enter to display the Open dialog box (see Figure 3-11).

•	Use Alt+F to open the File menu - do not release the Alt key.
Then, press O (or o) to display the Open dialog box.


File Menu

The File menu appears in the application window and in the program window.

File Menu (Application Window)

Menu Item	Description	Alt
New Open... Run Program...	Opens a new Program Window Allows user to open a new file Allows user to run a program directly from a file	Alt+F+N Alt+F+O Alt+F+R
Print Setup...	Allows user to setup printer	Alt+F+e
Recent File List 1...16	Allows opening one of up to sixteen recently opened files	Alt+F+1...16
Reset File List...	Allows user to clear most recently opened files list	Alt+F+L
Exit	Exit the application	Alt+F+x

File Menu (Program Window)

Menu Item	Description	Alt
New Open... Close	Greyed out - inactive Opens the Open File dialog box Closes the Program Window	Alt+F+N Alt+F+O Alt+F+C
Save Save As... Store Store As... Revert to last saved...	Saves program to existing file  Saves program to a user-specified file Stores program to existing file  Stores program to a user-specified file Reverts program to previously saved version	Alt+F+S Alt+F+A Alt+F+t Alt+F+e Alt+F+v
Run Program...	Allows user to run a program directly from a file	Alt+F+R
Print... Print Setup...	Allows current document to be printed Allows user to setup printer	Alt+F+P Alt+F+u
Recent File List 1...16	Allows opening one of up to sixteen recently opened files	Alt+F+1...16
Reset File List	Allows user to clear most recently opened files list	Alt+F+L
Exit	Exit the application	Alt+F+x


Help Menu

The Help menu appears in the application and program windows.

Help Menu

Menu Item	Description	Alt
Help Topics Help Index... Using Help...	Displays HTBasic for Windows Help Contents tab  Displays HTBasic for Windows Help Index tab Displays Windows Help Contents Tab	Alt+H+T Alt+H+I Alt+H+U
About HTBasic for Windows...	Displays HTBasic for Windows Information	Alt+H+A


Options Menu

The Options menu appears in the application and program windows.

Options Menu (Application Window)

Menu Item	Description	Alt
Color Mode Startup Memory Size Reset to Default Settings	Allows user to set color mode from 256 colors or 16 colors  Allows user to set the Startup memory size from 1 to 256 Mbytes Allows user to reset all option menu items to default	Alt+O+M Alt+O+D

Options Menu (Program Window)

Menu Item	Description	Alt
Edit Environment... Change MSI Alt Key Behavior	Allows user to set the edit environment Allows user to set Mass Storage Is path and device Allows user to assign alt key behavior to HTBasic or Windows	Alt+O+E Alt+O+h


View Menu

The View menu appears in the application and program windows.

View Menu (Application Window)

Menu Item	Description	Alt
Control Toolbar Status Bar	When checked, displays the control toolbar When checked, displays the status bar
View Menu (Program Window)

Menu Item	Description	Alt
Control Toolbar Status Bar	When checked, displays the control toolbar When checked, displays the status bar
XREF... File Statistics	Allows user to set cross-reference list Displays file statistics for open program including total line #s, memory (used & free), # of subs, and # DEF FN.	Alt+V+X Alt+V+F


Run Menu

The Run menu appears only in the program window.

Run Menu (Program Window)

Menu Item	Description	Alt
Run Pause Stop Continue	Runs an active program  Pauses a running program (run mode only) Stops a running program(run mode only) Continues a paused program (pause and stop mode only)	Alt+R+R Alt+R+P Alt+R+S Alt+R+t
Clear I/O BASIC Reset	Aborts an I/O operation that is in progress Resets the interface specified in the active program	Alt+R+C Alt+R+B


Search Menu

The Search menu appears only in the program window.

Search Menu (Program Window)

Menu Item	Description	Alt
Find... Replace...	Allows user to find a selected string Allows user to define search and replace options	Alt+S+F Alt+S+R
Goto...	Allows a Goto to a line, label, function or a subprogram	Alt+S+G


Edit Menu

The Edit menu appears in the program window.

Edit Menu (Program Window)

Menu Item	Description	Alt
Edit Mode	Allows user to move programs into Edit mode.	Alt+E+M


Chapter 4 HTBasic 7.0 Enhancements

Using This Chapter

This chapter describes new features, in addition to the GUI interface described in Chapters 1-3, that have been added to HTBasic Version 7.0 for Windows including:

New Features
Serial (RS-232) Driver
GIPB SICL Driver (HPIBS)
Errata


New Features

The following table shows a list of enhancements to the new HTBasic 7.0 for Windows release.

Enhancement Feature	Description
DISPLAY FUNCTIONS	Controls the display for control characters on the CRT. See Reference Manual page 126
SEPARATE ALPHA FROM GRAPHICS	Allows for separate Alpha and Graphics Displays.  See Reference Manual page 325
National Instruments Data Acquisition Card Drivers	Provides interface to National Instruments Data Acquisition boards.  See DAQNI.txt
GESCAPE CRT CODES  for Child window	The following codes have been added for manipulation of the HTBasic program window.  130 Maximize the window 131 Hide the window 132 Restore the window 135 Bring the window to the top 138 Hide / Restore the title bar 139 Returns the Title Bar enable flag 141 Minimize the window See Installing and Using Manual page 13
KBD Control Registers	The following codes have been added for directory CAT and mouse control: 204 Toggles directory file count during CAT.  0 - files are counted  1- directories report 0 files. 203 Mouse movement interaction with ON KBD$. 0 - Allows interaction  1 - Disallows interaction. 205 Mouse click interaction with ON KBD$.  0 - Allows interaction  1 - Disallows interaction. See User’s Guide page 187


Serial (RS-232) Driver

HTBasic version 7.0 has added improved functionality to the SERIAL32 driver. These improvements include: inbound TRANSFER, clearing of the receive buffer using RESET, and BREAK detection.

•	TRANSFER (inbound)

•	RESET (clear receive buffer)

•	Interrupt Support

•	BREAK detection


TRANSFER

The TRANSFER statement sets up unformatted data transfers between memory and a device. The data transfer normally occurs in the “background.” That is, the BASIC program continues to run in the “foreground” simultaneously with the background transfer. An inbound TRANSFER has the form:

TRANSFER @Serial TO @Buff

Where @Serial is the Serial Interface and @Buff is a buffer. For more details on TRANSFER see Reference Manual, page 356.


RESET

The RESET statement directed to a serial interface performs an interface reset. This interface reset will also clear the receive buffer of any information.


Interrupt Support

The SERIAL32 driver supports ON INTR and ENABLE INTR. The definition of bits used in the ENABLE INTR statement is the same as for STATUS register 8, given in Chapter 11 of the User’s Guide. An example showing use of interrupts with the SERIAL32 driver is given in the “Interrupt” section of Chapter 7, “General Input and Output” in the User’s Guide.


BREAK Detection

The serial interface can detect a BREAK condition using serial STATUS register 10 bit 4. To send a BREAK condition on a serial interface use serial CONTROL register 1.


GPIB SICL Driver (HPIBS)

The HP SICL driver for GPIB (HPIBS) now supports the TransEra Model 900 GPIB card under Windows NT. Before using this driver, first install the HP I/O Libraries (SICL) software. Second, using the TransEra I/O Configuration Utility, configure the interface for SICL.

Windows NT requires that each I/O card on your system be individually configured before it can be used with HTBasic. The TransEra I/O Configuration Utility allows the cards to be configured. After installing the 900 card utility, found in the 900Util directory on your HTBasic 7.0 CD-ROM, the Configuration Utility will run automatically. This program is approximately equivalent to the Hewlett-Packard iocfg32.exe program and is specifically designed for TransEra's I/O cards.


HPIBS Driver Options

Once the TransEra Model 900 IEEE card is configured for use with the NT operating system the HPIBS driver can be loaded in HTBasic. For details on loading GPIB drivers see the Installing and Using Manual, page 81.

Several GPIB hardware options, such as INTERRUPT and NOT SYS, are not used with the HPIBS driver. These characteristics are controlled by the I/O Configuration utility and cannot be changed by options to LOAD BIN.

The following options are available:

•	DEVICE OPTION

•	ISC OPTION

•	TIMEOUT OPTION

DEVICE Option. This option specifies the SICL symbolic name of the interface to be controlled. The symbolic name of each interface is set by the I/O Configuration utility. If you do not specify a DEVICE name, the default name “hpib7" is used. An example of specifying a symbolic name is:

LOAD BIN “HPIBS;DEV ieee7"

ISC Option. The ISC option specifies the Interface Select Code that HTBasic will use when communicating with the interface. If you do not specify an ISC, the default is 7. The following example specifies an Interface Select Code of 8:

LOAD BIN “HPIBS;ISC 8"

TIMEOUT Option. In addition to the CLR-I/O key, the TIMEOUT option provides a way to recover from “hung” keyboard commands. Note that this timeout for keyboard commands is independent from the ON TIMEOUT action specified in your program. The timeout value is specified in seconds, and a value of 0 deactivates keyboard timeouts. If you do not specify a TIMEOUT option, the default is 0 (never timeout). The following example sets the timeout for keyboard commands to 12 seconds:

LOAD BIN “HPIBS;TIME 12"


Eratta
Errata

The following items had modifications to them, or require additional clarification.


GCLEAR

For GCLEAR to act as a page eject on some plotters, it is necessary to use HPCL2 mode. This is set in the PLOTTER IS statement as an option.


ENTER SERIAL

While operating under Windows NT, a serial receive buffer of 4096 bytes is available. Under other versions of Windows, only 1024 bytes are available.


PS DUMP driver

The PS-DUMP device driver has added functionality that supports the ADJUST option. Certain display adapters use pixels that have different sizes in the horizontal and vertical directions. Without the ADJUST option, the driver dumps from these adapters using square pixels. This may result in an image that is too wide for its height. The ADJUST option forces the image to have a 4:3 aspect ratio regardless of its pixel size.


COLOR PALET
COLOR PALLET

Under the new GUI model the color pallet is handled quite differently than before. No longer are the -colors and the -cu startup switches necessary or valid.


-geometry switch

The -geometry startup switch specifies the size and (optionally) the position of the HTBasic window. The syntax is:

-geometry WIDTHxHEIGHT[+XOFF+YOFF]

The XOFF and YOFF settings are determined as the distance in pixels from the top left corner of the screen to the top left most point of the Application Window. The WIDTH and HEIGHT specifies the size in pixels of the interior client window.


GESCAPE CRT

GESCAPE CRT 33 and 34 follow the same rules as the -geometry switch. Previous versions of HTBasic used the external dimensions for the WIDTH and HEIGHT options.


Welcome
Welcome to the HTBasic Help system. The HTBasic Help System consists of four books including; What’s New in HTBasic 7.0 for Windows, Installing and Using Manual, User’s Guide, and Reference Manual.  Each of these books is outlined below.

What's New in HTBasic 7.0 for Windows

The What’s New in 7.0 Manual describes the enhancements and changes made to HTBasic 7.0 for Windows release.   HTBasic 7.0 is specifically designed for the 32-bit Windows platform including Windows 95, Windows 98, and Windows NT.  This manual includes a thorough description of the new graphical interface with pull-down menus, dialog boxes, scrollbars and toolbars introduced in the 7.0 release.

Installing and Using Manual

The Installing and Using Manual details the installation process and initial configuration instructions for HTBasic. HTBasic is highly configurable including loadable device drivers, customizing keyboard key assignments, defining additional LABEL characters or configuring your PC to duplicate the workstation environment. The following topics are found in the Installing and Using Manual:

•  Installing HTBasic	• Serial and IEEE-488 (GPIB or HP-IB) drivers
•  Keyboard Key Assignments	• Transferring Programs and Data from HP BASIC
•  CRT and Graphic (Plotter) Drivers	• Customizing the Environment
•  Printer and Image File Drivers	• Solutions to Common Problems
•  Graphic Input Drivers	• Changes From Earlier Releases
User's Guide

The User's Guide contains in-depth information about using the HTBasic language. It is arranged topically.  These advanced topics will allow the user to speed program development and more fully exploit the power of HTBasic.  The following topics are found in the User’s Guide:

•  Getting Started	• Porting HP BASIC programs to HTBasic
•  Language Elements	• Program Flow Control
•  Mathematics	• Graphics
•  General Input and Output	• CRT, Keyboard, and Printer
•  Files	• IEEE-488 STATUS Registers
•  Serial (RS-232) I/O	• Other I/O Destinations & Sources
•  International Language Support
Reference Manual

The Reference Manual consists mainly of a dictionary style presentation of HTBasic keywords. Most keywords include syntax definition, samples, description of the keyword and usage and even sample programs.

The Reference Manual also includes a chapter of definitions, a statement summary table, a list of error messages and an ASCII code chart. The ASCII code chart contains ASCII, decimal and hexadecimal values and IEEE-488 commands and addresses.

Copyright ® 1988-1999 by TransEra Corp.


Readme File

            HTBasic for Windows Release Notes

                        Release 7.2

                  TransEra Corporation

                  375 East 800 South

                     Orem UT 84097

                phone (801)-224-6550

                      fax (801)-224-0356

         Web page: http://www.transera.com

          ftp site: ftp://ftp.htbasic.com/pub/htbasic

           e-mail: htb-sales@transera.com or

                   htb-support@transera.com

_______________________________________________________

This file contains information regarding changes and

additions that have been made since the last printing

of the manuals.

Manual Corrections/Additions

-----------------------------------------------------

Installing and Using Manual - Tenth Revision

Page 17  The Keyboard Reference Guide and the

         Keyboard Functions template no longer

   ship with HTBasic. For this information

   see chapter2

Page 37  Add: 1600. The 1600 option provides

   compatibility for most newer HP DeskJet

   printers. This option is ignored unless

   the PCL5 and COLOR options are included.

Reference Manual - Tenth Revision

Page 51  Sample should read:

   Msb=BINIOR (-1,2^14)

Page 76  Last paragraph include sentence:

   String variables must have their length

   declared when declared in a COM variable.

SRM/UX  Capability

-----------------------------------------------------

HTBasic can now be a full SRM/UX client with the addition of

a DLL available through Test and Measurement Systems (TAMS).

This allows an HP 200/300 with BASIC/WS that was connected to

an SRM/UX system  to be replaced by a PC and HTBasic.

SRM/UX networking now allows files to be shared between

HTBasic on a PC and HP computers with HP-BASIC/WS or

workstations with HP-BASIC-UX/300 or HP-BASIC-UX/700.

Now in an SRM/UX network an old series 200/300 computer can be

replaced with a PC running HTBasic without any other changes

being made to the way the system operates. SRM/UX provides

all of the networking management for the TransEra PC client.

This new capability dramatically increases the ability of

HTBasic to be a direct replacement for HP-BASIC/WS.

Changes\Fixes Since Last Release

-----------------------------------------------------

**************Release 7.1 to Release 7.2**************

1. Support was added for Outbound Serial TRANSFER, previously

only Inbound Serial TRANSFER was supported.

2. SERIAL32 driver. SERIAL32 driver occasionally left threads open

if ON INTR was in use when HTBasic was closed. Under NT, this

was seen and closed using the Task Manager. Under

other versions, you had to re-boot. This has been repaired.

3. Dithering was added to provide better color representation

when using only 256 colors in a system that supports more than

256 colors. This feature is enabled by default and can be

modified with the following CONTROL statements.

CONTROL crt,110;1 ! turn dithering off

CONTROL crt,110;0 ! turn dithering on - default

If the system does not support the use of dithering, solid

colors will be used despite these settings.

4. The keyword QUIT can now be used to close just the

Child Window or the entire HTBasic application. By default

its behavior is to close only the Child Window. This can

be modified with the following CONTROL statements.

CONTROL KBD,210;1 ! closes entire application

CONTROL KBD,210;0 ! closes only child window - default

5.  Using the SEND keyword with the DATA command

and the GPIBNI driver to send low level data across the bus

is now allowed.

6.  GPIBNI driver was updated to 1.6 version of NI API.

7.  CLR/IO On WinNT with the HPIBS driver is not supported.

The driver appears to hang when it is communicating with

the SICL part of the driver and does not come back to

check if a CLR/IO has been issued. It is recommended that

ON TIMEOUT is utilitized instead.

8.  SET ECHO and scrolling causes HTBasic to slow down.

Control register KBD 207 was added to allow dynamic thread

priority setting.  With the thread priority set to NORMAL,

(i.e. 0) graphics will run quicker.  If the user needs

the ON KNOB or ON CYCLE to work properly, he should

set KBD 207 to 3. This maps to THREAD_PRIORITY_TIME_CRITICAL.

This will give the mouse better response time, but will

compromise graphics speed.

9.  DISP and INPUT now properly display Japanese fonts.

10. DISP character control. DISP CHR$(129)&"Hello"&CHR$(128)

now works properly.

11. Middle mouse was not responding with READ LOCATOR.

This has been fixed.

12. The -alt command line switch does not accept long file

name format if there is a space in the filename. Release 7.2

now allows the user to put quote marks around the whole file

name so the operating system doesn’t break up the filename.

13. The Help About box now reflects the release version. This

can also be accomplished by using the SYSTEM$ ("VERSION:HTB").

14.  Swedish and Italian keyboards are not picking up

the backslash key properly. The right alt+- key gives inverse

"k" and $ but should have given a backslash "\". Adding -gkey

to the command line parameter will enable this functionality.

NOTE: alt +GR is the right alt key.

15. Running multiple instances of HTBasic required ENTER to be

pressed multiple times to parse lines. This was corrected to

prevent any interaction between multiple instances of HTBasic.

16. Changing ALPHA PEN now resets both the PRINT PEN and the

KEY LABELS PEN.

17. SYSTEM$ ("PLOTTER IS ") returned a 6 for CRT when PLOTTER

IS was set to a file. It now properly returns the filename.

18. When the program is waiting for a mouse click, using the

STOP icon would hang the program or closing the child window

without closing the parent window would require a re-boot.

These were corrected so that no other interaction from the

user is permitted while waiting for a response from the mouse.

19. Recent File list did not reset a second instance of HTBasic.

This is now corrected so that the recent file list is shared

between instances of HTBasic.

20. Loading a PROG type program from an older version would

begin re-numbering line 655536 at 1. This has been corrected

so that loading older PROG type programs will read in all

linenumbers without re-numbering.

21. The -geometry command line switch for values less than

100 is now supported. If the values are less than 100 they

are now interpreted as characters rather than as pixels.

22. Open no longer overwrites the program you are opening with

the program in memory if Cancel is selected on Save/Store

changed program dialog.

**************Release 7.0 to Release 7.1**************

1. The TransEra Model 600 GPIO, HP E2075 GPIO cards, and

the TAMS 60622 GPIO cards are supported by the 7.1 release.

The GPIOS driver is supported under all Operating Systems, and

the GPIO driver, supporting the TransEra Model 600 GPIO card,

is supported under Windows 95/98 only. The TransEra Model 650

card will have support in future releases.

2. In addition to the new GUI (Graphics User Interface)

look and feel of version 7.1, we have also provided a

version of 7.1 that is familiar to users of earlier

versions of HTBasic. This executable is installed

along with your full GUI version. It is called

HTBwin.bak. By renaming this executable to HTBwin2.exe

you will have full access to the older look and feel.

It contains all fixes and enhancements that the GUI version

does except the SEPARATE ALPHA functionality and the new GUI

functionality.

3. At the current time there is limited BASIC Plus

support for the 7.1 release. To use BASIC Plus, it is

required that you use the Non-GUI version as mentioned in

item 3 above.

4. By default the Program Modified Dialog Box is enabled.

To disable this dialog box insert the following line into

your AUTOST:

CONTROL KBD,100;0

With the release of 7.1, programmatic program changes will

not cause this dialog box to appear.

5. When placing alpha on top of previously drawn graphics

while in SEPARATE ALPHA mode, the alpha will first black

out the line where it is to place the text prior to placing

the text. This has been repaired for the 7.1 release.

6. Under Windows 95, it was not possible to print to the

default Windows printer unless it was connected directly

to a physical port or mapped to a network port. If your

printer was mapped only to a network printer without

being assigned a port number, error 401 would occur.

This has been repaired to allow printing to non-mapped printers.

7. Changing the printer in the Printer Setup dialog box

from within HTBasic would not change the  Windows printer

mapped to ISC 10. It would remain assigned to your default

Windows printer. This has been repaired to allow for

changing the assigned printer to ISC 10.

8. LIF utilities (HPCOPY, HPCAT, and HPPURGE) remain

non-functional under Windows NT. Under DOS, or Windows

3.x, or 95/98 they are fully functional. If you have an

NT machine, it is recommended that you either 1) boot

to previous version of DOS to perform the necessary

transfer; 2) Boot to a DOS boot disk and perform the

necessary transfer, or 3) purchase a third party

transfer utility.

9. Updated HPIBS (SICL) device driver for GPIB Cards.

This driver has a repair that allows large data transfers using

OUTPUT and ENTER statements.

10. When using SICL GPIB devices, timeouts were not functional.

Previously the following program would never timeout. This has

been repaired to give full functionality.

5   LOAD BIN "HPIBS;TIMEOUT 1"

10  ON TIMEOUT 7,1 GOTO Timetrap

20  Testsub

30  STOP

35  !

40  Timetrap: PRINT "TIMEOUT - MAIN"

50  END   55  !

60  SUB Testsub

70    ON ERROR GOTO Errtrap

80    ENTER 700;A$        ! No Instrument @ 700 Address

90    PRINT "No Timeout"  ! This message shouldn't be printed

100   SUBEXIT

110  Errtrap: PRINT "Sub ERROR : ["&ERRM$&"]"

120  SUBEND

11. GPIB support in the 7.1 release is limited to the following

three drivers: HPIBS, GPIBNI, and GPIB. Users with older cards

that use the NAT488.1 standard will need to upgrade their

hardware to the newer 488.2 or SICL standard, or continue using

the 6.1 version.

12. DUMP ALPHA and DUMP GRAPHICS will now DUMP each plane

separately with each DUMP DEVICE. Previously this was only

supported by WIN-DUMP.

13. When using Lexical order files, some buttons on the control

toolbar were rendered non-functional. This has been corrected,

allowing full use of Lexical order files.

14. The SCRATCH ALL command now will reset the MSI to startup

directory. Previously it had no effect on the MSI.

15. The GRAY option previously had no effect on the PS-DUMP

driver. This has been corrected to allow GRAY scale PostScript

DUMPs.

16. The INPUT command was previously limited to 63 characters.

This has been increased to now handle up to 256 characters.

17. The CAT command when used with CONFIGURE LONGFILENAMES ON

switch, will report year data in the yyyy format. The CONFIGURE

LONGFILENAMES ON is on by default.

18. The following GESCAPE CRT codes have been added for

manipulation of the program window.

    46  Turn the Toolbar Off.

    47  Turn Toolbar On.

    48  Turn Status Bar Off.

    49  Turn Status Bar On.

    50  Remove Main Menu.

    52  Disable Borders on Parent Window.

    53  Enable Borders on Parent Window.

    54  Disable Minimize button on Parent Window.

    55  Enable Minimize button on Parent Window.

    56  Disable Maximize button on Parent Window.

    57  Enable Maximize button on Parent Window.

    58  Disable Close button on Parent Window.

    59  Enable Close button on Parent Window.

19. The following GESCAPE CRT codes have been added for

manipulation of the program child window.

    130  Maximize the window.

    131  Hide the window.

    132  Restore the window.

    135  Bring the window to the top.

    137  Returns the Title Bar enable flag.

    138  Hide / Restore the Title Bar.

    141  Minimize the window.

    152  Disable Borders on Parent Window.

    153  Enable Borders on Parent Window.

20. The following KBD Control Register code has been added

for directory CAT control:

    204  Toggles directory file count during CAT.

         0 - files are counted.

         1- directories report 0 files.

21. The following KBD Control Register codes have been added

for ON KBD and mouse interaction:

    203  Mouse movement interaction with ON KBD$.

         0 - Allows interaction.

         1 - Disallows interaction.

    205  Mouse click interaction with ON KBD$.

         0 - Allows interaction .

         1 - Disallows interaction.

22. On-line help is now displayed in new Windows 2000 style.

**************Release 6.1 to Release 6.1b**************

1. PCL.DW6 -Updated PCL driver, this driver now correctly

states its version number.

2. GPIBNI.DW6 -Updated GPIB driver for National Instruments GPIB

cards. This 32-bit only driver now supports all GPIB boards

supported by National Instruments. This includes the plus "+"

cards (cards with built-in bus analyzers) that were previously

unsupported.

3. HPIBS.DW6 -Updated HPIBS (SICL) device driver for GPIB Cards.

This driver has a repair that allows large data transfers using

OUTPUT and ENTER statements.

4. The addition of movement of the mouse generating ON KBD

interrupts placing UP, DOWN, LEFT, or RIGHT keystrokes into the

KBD$ buffer. Previously the mouse movements were ignored by the

ON KBD statement. In the 6.1a update we have added a control

register to turn off this functionality. The syntax is as

follows:

CONTROL KBD,203;0 ! default, mouse will give KBD interrupts

CONTROL KBD,203;1 ! turns off mouse interrupts to KBS$

5. There was a problem introduced with the 6.1 release

concerning the graphics area surrounding the Softkeys. Despite

the presence or absence of the softkeys, graphics would not be

displayed in this region. This is fixed  in the 6.1a update.

6. The WAIT OFF option for the EXECUTE command has been added.

Using this option will cause DOS applications to return control

to BASIC without waiting for user intervention. Not specifying

this switch when using an EXECUTE statement with a DOS

application will cause the DOS program to wait with a "press

any key to continue" prompt. When the Windows application is

closed no DOS box will appear when using the WAIT OFF option.

To prevent a DOS box from appearing at all, use the following

syntax: EXECUTE CHR$(13)& "CALC".

7. CAT of an empty directory would leave null information.

This has been repaired to give a blank display.

**************Release 5.X to Release 6.1**************

1. Caps Lock control from inside HTBasic. The commands is

CONTROL KBD,0;1 OR CHR$(255)&"U". The control statement uses

the values 0 and 1 for on or off and the output CHR$(255)&"U"

simply toggles the caps lock state.

10	CONTROL KBD,0;1  ! Turns on caps lock

20	CONTROL KBD,0;0  ! Turns off caps lock

30	OUTPUT KBD; CHR$(255)&"U" !  Toggles caps lock

40	END

2. CAT of an invalid filename, or non-existent directory

or file would not generate an error, just an empty listing.

Programs that used CAT to test the validity of a filename may

have been rewritten to use ASSIGN to test for a file. CAT of

invalid filename or non-existent directory now generates error

56 "File or path not found" in these cases.

3. On Win3.x or WinNT, CAT "*."  listed only the files that

have no extensions.  On Win95, it listed all files. CAT "*."

has been fixed to only list directories and files with out

extensions on all platforms.

4. Full UNC (Universal Naming Convention) support added.

5. Colors customized through CRT control registers 15, 16,

and 17 were reset to default whenever the HTBasic window

was resized. These registers are fixed to retain their

settings despite window resizing.

6. CONFIGURE MSI failed if string length exceeded 30 characters.

This has been fixed to allow 256 characters in the statement.

Note: It is still necessary to include the last \ in the PC path

statement.

7. ISC 26 was limited to ports lpt1-3. This has been repaired

to now allow assigning the ISC to any valid port. This may be

network mapped, or physical. The syntax to control which port

ISC 26 is assigned to is: "CONTROL 26,102;X" to assign it to

lptX.

8. In HP RMB, a sub that performs a DELSUB on a range of Subs

including itself, will succeed in deleting all the following

subs, though it would error out when it tried to delete itself.

Under HTBasic for Windows, it would error out, without deleting

any subs. This functionality has been repaired to match the

workstation's behavior exactly.

9. DOS error 21 on Win3.x.  This was a hardware problem when

using more than 32MB of RAM when running older versions of

WIN32s. This has been fixed with this release by mandating

an update of WIN32s to version 1.30c during installation.

10. EXPANDED option was not working correctly using ISC26 and

the PCL driver (every other line was inverted). This now dumps

properly. Syntax for this option is: CONFIGURE DUMP TO "PCL" &

DUMP DEVICE IS 26.

11. When Windows is set to more than 256 colors or more than

1024x768 GLOAD generates a missing option or configuration

error during screen captures and restores . This was corrected

by the implementation of DirectDraw extensions. This is only

available in 32-bit windows. To enable DirectDraw extensions,

place the -X option on the startup line of your HTBasic start

icon. To install this version, select custom install and select

the directX enabled version. This will install htbwinx.exe.

Your shortcuts will point to this new executable.

12. The exclamation mark was not interpreted as a comment

delimiter when typed at the end of an IMAGE line.  IMAGE

codes like "-" or "#" were still interpreted by the IMAGE

statement, even after the exclamation mark. This has been

fixed to always interpret the ! as a comment indicator.

  10   	FOR N=1 TO 10

  20   	PRINT "------------------------------ !"

  30   	PRINT USING Toto;"Hello",N

  40  	Toto: IMAGE "IMAGE 1 [",5A,"]",3D

  50   	PRINT USING Toto1;"Hello",N

  60  	Toto1: IMAGE "IMAGE 2 [",5A,"]",3D    !-comment

  70   	PRINT USING Toto2;"Hello",N

  80  	Toto2: IMAGE "IMAGE 3 [",5A,"]",3D    !#comment

  90   	PRINT "------------------------------ ?"

  100  	NEXT N

  110 	END

13. WIN-DUMP driver gave ERROR 2 when using large complex

Windows printer drivers. This was fixed with the same

DirectDraw as in number 11 (eleven) above.

14. Values between x.x495" and "x.x500" are rounded up instead

of down.  For example: DROUND (12.3499,3) returned 12.4. This

was repaired to give accurate rounding.

15. Negative pen numbers were not operational prior to release

6.x. Negative pen numbers have been implemented and are useful

in erasing positive pen graphics. However, negative pens should

only be drawn over their positive counterparts. Unexpected

output may occur if mixing pen numbers.

16. Unless an ON KNOB definition is active, movement of the

mouse generates ON KBD interrupts and places UP, DOWN, LEFT,

or RIGHT keystrokes into the KBD$ buffer. Previously the

mouse movements were ignored by the ON KBD statement.

17. PRINTALL IS would not work properly unless you did a

PRINTER IS to the same device first. PRINTALL IS now works

independent of PRINTER IS.

18. CAT command when using NFS drives give MEMORY OVERFLOW.

This has been repaired to allow for all NFS drive mapping.

19. WIN-DUMP INVERT would not INVERT properly. It has been

repaired to properly INVERT DUMPED output. This only works

if colors are 256 or less. For example:

10  CONFIGURE DUMP TO "WIN-DUMP" !INVERT IS ON BY DEFAULT

15 !CONFIGURE DUMP TO "WIN-DUMP;INVERT" ! TURNS OFF INVERT

20  MOVE 50,50

30  RECTANGLE 10,10,FILL

40  DUMP GRAPHICS

50  END

20. XREF with large files and long variable names: 40,000

lines, numbered by 10. EDIT line 132040 would cause GPF as

well as every 8960 lines.  This has been repaired to allow

the longer variable names in XREF and to use line number

132040.

21. XREF with lines longer than 80 characters caused

formatting problems. This has been repaired to allow for

up to 256 character long lines.

22. Month input is now allowed for both three-character

abbreviations as well as spelled out. For example:

10 PRINT DATE$(DATE("10 FEB 1998"))     ! Works fine.

20 PRINT DATE$(DATE("10 FEBRUARY 1998"))! Reported year as 0

30 PRINT DATE$(DATE("10 MARCH 1998"))   ! Reported year as 0

40 END

23. The MAT statement did not allow assigning elements

of a two-dimensional array to a one-dimensional array,

such as the following. This has been repaired to match

Workstation BASIC.

10   ALLOCATE Tab1(1:5)

20   ALLOCATE Tab2(1:5,1:5)

30   MAT Tab1= (5)

40   MAT Tab2= (6)

50   CALL Tab1d_2d(Tab1(*))

60   CALL Tab1d_2d(Tab2(*))

70   END

80   !

100  SUB Tab1d_2d(Tabx(*))

110  ALLOCATE Tab(1:10)

120  IF RANK(Tabx)=1 THEN MAT Tab(2:4)= Tabx(1:3)

130  IF RANK(Tabx)=2 THEN MAT Tab(2:4)= Tabx(2,2:4)

140  ! <-> Here was Error 16

150  SUBEND

24. The GPIBTNT driver had timeout problems under NT 4.0.

This driver has changed names from GPIBTNT to GPIBNI. This

driver is a 32-bit driver only for Windows 95/98 & NT. It

currently supports under Windows 95/98 all of the NI GPIB

boards except the plus "+" cards with the built-in bus

analyzer.

Under NT it supports all of the NI GPIB boards, except the

GPIB PCI and the GPIB+ cards, with the built-in bus analyzer.

If your card supports hardware timeouts specify "TIMEOUT 0"

in LOAD BIN to disable software timeouts and use

"CONTROL ISC,100;V" to set hardware timeout value to V. See

your Hardware documentation for these values and their meaning.

If you wish to use software timeouts set V to 0 and see

"If your card does not support hardware timeouts:" Timeout

value n is ignored in "ON TIMEOUT n GOTO linenumber"

If your card does not support hardware timeouts software

timeouts are enabled by default, but you may specify

"TIMEOUT 0" in the LOAD BIN statement. Timeout

value n in: "ON TIMEOUT n  GOTO line number" is the

value used for the timeout value in seconds.

It is possible to enable both software and hardware timeouts.

If this is done the timeout value is approximately the sum of

the two timeout values.  In some circumstances the timeout

value will be unpredictable.

25. Using an EXECUTE statement while the SERIAL32 driver is

loaded will no longer reset the serial interface to its default

settings. If a program expects the serial interface to be reset

to these defaults it is now necessary to perform a RESET X where

X is the ISC of the serial port you wish to re-set.

26. When changing the baud rate in the SERIAL32 driver the parity

would reset to default. The baud rate no longer effects the parity

in this manner.

27. DUMP DEVICE IS <file> should not allow dumping to LIF ASCII

file type, it should cause error 58. Previously this would not

generate an error.

28. DUMP DEVICE IS <bdat file> would delete the bdat header first

and then dump screen contents to the bdat file. This has been

repaired to retain the bdat header information. If you want a

file of just the screen dump, which is a bitmap file, use a

different file type to DUMP to.

29. If PLOTTER IS <file> file began with the numeral "1" when

using SYSTEM$ ("PLOTTER IS") would return a "6". This has been

repaired to return the whole file name.

30. ON TIMEOUT support was added for ISC 10 and printing.

31. PRINTER IS cannot be set to a LIF ASCII file. Doing so

will result in error 58 and will not assign the PRINTER IS

to the file. This previously resulted in the error message but

the file would remain assigned and the file would fill with

unrecognizable characters.

HTBasic Differences

-----------------------------------------------------

This section lists the most common differences between HTBasic

for Windows and HP BASIC 200/300/400/700 (RMB).  For detailed

information on differences and porting issues, see online

help, the "Installing and Using Guide," and the "User's Manual"

chapter 2.  Specifically note the CONFIGURE statements.

 * To transfer BASIC programs between HTBasic and RMB use

   the SAVE/GET commands.  PROG files cannot be directly shared

   between HTBasic for Windows and RMB.

 * Use SYSTEM$("VERSION:HTB") to programmatically determine if

   executing on HTBasic for Windows.

 * In the HTBasic editor, results from directly executed commands

   are displayed in the message line at the bottom of the screen.

 * Operations which cause an error may not produce exactly the

   same error number as RMB.  For example, if an out-of-range

   value is passed to an INTEGER parameter, one platform might

   report error 19 (value out of range) and the other platform

   might report error 20 (integer overflow).

 * The PRT printer address constant returns 10 (the ISC of the

   Windows Print Manager Driver) instead of 701.  Use CONFIGURE

   PRT TO 701 to change.

 * Refer to either online help "keyboard functions" or the

   "Installing and Using Guide" chapter 8 for the mapping of

    keyboard functions.  You can use CONFIGURE KEY to re-map any

    key to the function you wish.

 * RMB uses the Roman-8 character set; HTBasic uses the Latin-1

   character set. Therefore, characters below CHR$(32) and above

   CHR$(128) display differently.  Refer to Chapter 13 in the

   "User's Manual".

 * RMB and HTBasic have different actions for negative pen

   numbers. Depending upon the device and drawing mode, RMB

   negative pens either erase or complement the corresponding

   color.  In HTBasic, a negative pen complements the color

   map index, which is not the same as complementing the color.

 * HTBasic restarts a line-type pattern with each line segment

   drawn. RMB tries to continue the line-type pattern across

   sequential line segments.

 * The destination of an ON...CALL statement can be deleted in

   HTBasic. In RMB, attempts to delete these SUBs cause an error.

 * When doing a CAT TO S$(*) with HTBasic, the first array element

   has the text "DIRECTORY:" before the actual directory name.

 * RMB reserves 3072 bytes for softkey macros, HTBasic only

   allocates 1024 bytes for this purpose.

 * I/O Differences:

    - TRANSFER has limited functionality in this release.  For

      more information, see the io_info.txt file.

    - Some error- and EOF-handling in the ENTER statement is

      different.

 * Mass Storage Differences:

    - Filename wildcards are only available through the CAT

      statement.

    - INITIALIZE is not supported, so HTBasic cannot create RAM

      volumes.  For RAM volumes, use a DOS RAM disc program

      instead (e.g. VDISK.SYS, RAMDISK.SYS). These volumes are

      accessed just like any other DOS disk (e.g. C:, F:, etc.).

    - There can be differences in file formats and byte ordering

      within files. See the ASSIGN statement in the "Reference

      Manual" for more information.

 * MSUS Format:

    RMB format: [directory path] [filename] [:msus]

    HTBasic format: [drive:] [directory path] [filename]

    You can map the RMB format to the HTBasic

    model using the CONFIGURE MSI statement.

 * The following RMB CSUB utilities are not provided:

    PHYREC: No substitute

    GDUMPC: Automatically provided by DUMP

      GRAPHICS if current Windows printer

      supports color.

    BPLOT:  Bload() and Bstore() functionality

      now provided through extensions

      to the GLOAD and GSTORE statements.

 * Blinking PRINT Attribute is not supported.

LIMITATIONS

-----------------------------------------------------

Due to the resolution of the PC clock (about

55 milliseconds), all timing functions (WAIT,

ON CYCLE, ON DELAY, ON TIME, ON TIMEOUT, etc.)

will be rounded to the nearest clock interval.

The LINE TYPEs supported by this release are

limited.  Line type 3 is drawn the same as 4,

and 6 is drawn the same as 7.  The optional

repeat length is not supported on the display.

Also, not all display systems support dotted or

dashed lines.  In this case, dotted and/or

dashed line types are drawn as solid lines.

HTBasic cannot directly access LIF diskettes.

Use the HPCAT, HPCOPY, and HPPURGE utilities

provided with the product. These utilities

are presently not supported under the Windows

NT operation system.

HTBasic does not support running more than one

instance of HTBwin at one time on Windows 3.1x.

(This is supported on 32-bit Windows.)

The SET and RETURN clauses of the ASSIGN, DIALOG,

CONTROL, and STATUS statements are limited to 36

attribute pairs.

The HP 82335 HP-IB interface is a memory-mapped

device.  As such, it may have collisions with your

expanded memory space.

In Windows 3.1x, recursive function calls

(DEF FNxxx) can overflow the stack and cause

HTBasic and/or Windows to crash.

When plotted labels are rotated with LDIR,

isotropic scaling of the label may not be

maintained on some plotting devices.

If you attempt to CAT a networked directory

containing a file named "CON", HTBasic will hang.